home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / wp / wpmd3.zip / WPMD3.DOC < prev   
Text File  |  1992-09-27  |  38KB  |  780 lines
  1. Copyright (c) 1989-92
  2. by David Seidman
  3. September 1992
  4.  
  5.  
  6.                          Software by Seidman's
  7.  
  8.                                   WPMD
  9.  
  10.                    The File Doctor for WordPerfect(r)
  11.  
  12.  
  13. Things can go wrong with WordPerfect 5 (that is, 5.0 or 5.1) document 
  14. files.  Text may disappear.  WordPerfect 5 (WPerf5) may stop 
  15. recognizing a file as a WPerf5 document file.  And other strange things 
  16. may happen.  We don't always know why they happen, but we can do 
  17. something about them when they do. 
  18.  
  19. If your WPerf5 files get sick, WPMD, the WordPerfect 5 File Doctor, may 
  20. be able to help.  It cannot help if what should be in your file has 
  21. simply vanished from your disk, but that is not what usually happens.  
  22. Check the size of your file with the DOS DIR command.  If the number of 
  23. bytes is not too small, your text is probably still there, and it is 
  24. time to call the File Doctor.  WPMD cannot cure all the maladies that 
  25. may afflict WordPerfect files, but it can cure many of them. 
  26.  
  27. WPMD has two ways of operating.  The Ordinary Way is very simple to 
  28. use.  The other way, Drastic Surgery, is a bit more complicated.  The 
  29. Ordinary Way is usually all you need, but sometimes you need Drastic 
  30. Surgery and sometimes you need both. 
  31.  
  32.  
  33. What The Ordinary Way Does
  34. --------------------------
  35.  
  36. WPerf5 function codes are stored as series of bytes that have meaning 
  37. to WPerf5, not as what you see in Reveal Codes.  If even one byte in a 
  38. code is incorrect, WPerf5 can get hopelessly confused.  This confusion 
  39. can have dramatic results.  For example, the entire text of your 
  40. document may disappear from the screen; even though the text is 
  41. actually all there in the file, WPerf5 shows nothing but a blank 
  42. screen.  Less dramatically, you may lose part of the text, a "loop" may 
  43. develop so that moving the cursor down in the document brings you to an 
  44. earlier part of it, or the text may become incorrect in other ways. 
  45.  
  46. WPMD handles this problem by looking for messed up codes.  Usually when 
  47. it finds them, it deletes them and leaves the message **FIX** in their 
  48. place.  If WPMD's cure works well, you just retrieve the fixed file 
  49. into WPerf5, search for **FIX** (use an Extended Search, because WPMD 
  50. may have fixed a problem in a footnote, endnote, header, footer, or 
  51. text box), and see if anything is missing at that point.  At least one 
  52. code is likely to be missing.  In addition, you will often see garbage 
  53. -- erroneous characters and codes -- after the **FIX** message.  The 
  54. garbage is the remains of broken codes.  Simply delete it. 
  55.  
  56. In rare cases, WPMD will cure the problem without leaving a **FIX** 
  57. message.  This happens when WPMD figures out exactly what the incorrect 
  58. bytes should be and replaces them with the correct ones. 
  59.  
  60. In all cases, when WPMD fixes the file, PROOFREAD carefully.  WPerf5 
  61. may have changed characters in your text in ways WPMD cannot detect. 
  62.  
  63.  
  64. What Drastic Surgery Does
  65. -------------------------
  66.  
  67. Use Drastic Surgery when (a) WordPerfect does not recognize your 
  68. document as a WP5 document file ("incompatible file format" is the 
  69. usual tipoff to this problem); (b) WordPerfect tells you there is 
  70. insufficient space on the WP disk to retrieve the file and you suspect 
  71. there is enough space; or (c) all else fails (that is, after you have 
  72. tried the Ordinary Way, and after you have tried FIXPRE, which is 
  73. briefly described below). 
  74.  
  75. While the Ordinary Way fixes your text, Drastic Surgery does nothing to 
  76. the text of your document.  Instead, it amputates the document prefix, 
  77. the beginning part of the document file you do not see in WPerf5, and 
  78. replaces it with another document prefix.  This amputation loses a good 
  79. deal of information, including graphics, styles, and initial codes 
  80. (unless you have the same information available in the prefix of 
  81. another file).  If the only problem is a problem in the prefix, Drastic 
  82. Surgery may be all the cure you need.  But Drastic Surgery may simply 
  83. allow WPerf5 to get to the rest of the document, where there could also 
  84. be problems.  So if Drastic Surgery does not fully cure your file, try 
  85. the Ordinary Way again, using the re-prefixed file produced by Drastic 
  86. Surgery as the input file. 
  87.  
  88.  
  89. Running WPMD
  90. ------------
  91.  
  92. You can give instructions to WPMD from the DOS command line, or you can 
  93. use the program interactively.  To use it fully interactively, you 
  94. start the program by typing its name at the DOS command line and 
  95. pressing ENTER: 
  96.  
  97. C>WPMD
  98.  
  99. WPMD does not allow you to change the colors it uses in interactive 
  100. operation.  If you do not like the colors, you can start the program 
  101. this way: 
  102.  
  103. C>WPMD -M
  104.  
  105. The program will then run in monochrome mode.
  106.  
  107. If you start the program like this:
  108.  
  109. C>WPMD -?
  110.  
  111. WPMD will display a summary of the instructions for using it in command 
  112. line mode. 
  113.  
  114. If you start WPMD with either just WPMD or WPMD -M, the program will 
  115. ask you to enter an input file name.  Type the name (including drive 
  116. and directory, if necessary) of the sick file.  When you have finished 
  117. typing and editing the file name (conventional editing keys work), hit 
  118. the ENTER key.  If you include a DOS wildcard (* or ?) in the filename, 
  119. a window with a list of files matching the file specification you 
  120. provided will appear.  Move the cursor to the file name you want to 
  121. select and hit the ENTER key.  The selected file name will appear as 
  122. the response to the program's request for an input file name.  You can 
  123. then edit it or hit the ENTER key to accept it.  If you change your 
  124. mind and want to exit the program without selecting an input file, 
  125. delete the response to the prompt and hit ENTER. 
  126.  
  127. WPMD will then ask you for the name of an output file, the fixed file 
  128. it is to create.  It will propose a file name, which you can accept by 
  129. hitting the ENTER key.  Usually, the name it proposes will be the name 
  130. (including path) of the input file, but with the extension FIX.  If a 
  131. file with that name already exists, WPMD will try extensions from X01 
  132. to X99.  If all of those are in use with that file name, WPMD will not 
  133. propose a file name.  If you like the proposal but would like to edit 
  134. it a bit, move the cursor with an arrow key before doing any editing.  
  135. If you do not like the proposal and would like to enter a new name, 
  136. just start typing; the proposed name will vanish.  If you would like to 
  137. restore the original proposal, hit CtrlR. 
  138.  
  139. If there are problems with the input or output file name you supply, 
  140. WPMD will ask you to take corrective action.  It should be obvious how 
  141. to respond. 
  142.  
  143. After you have supplied the input and the output file names, WPMD will 
  144. ask you whether you want to use the Ordinary Way or Drastic Surgery.  
  145. If you want to use the Ordinary Way, type O or hit the ENTER key.  If 
  146. you want to use Drastic Surgery, type D. 
  147.  
  148. Once the Ordinary Way starts, WPMD may ask you if you are sure the 
  149. input file is a WordPerfect 5 document file.  If it asks, answer with 
  150. either Y or N.  If the answer is Y, the program continues.  If the 
  151. answer is N, the program quits.  WPMD may also ask you if the input 
  152. file is "locked," or password protected.  If the answer is N(o), the 
  153. program continues.  If the answer is Y(es), the program quits, because 
  154. WPMD cannot work with locked files.  It may also quit in the face of 
  155. various problems, which it will explain. 
  156.  
  157.  
  158. Using The Ordinary Way From The Command Line
  159. --------------------------------------------
  160.  
  161. In addition to using the Ordinary Way as described above, you can also 
  162. start it from the DOS command line: 
  163.  
  164. C>WPMD Infile Outfile [-M]
  165.  
  166.        Infile is the name (including drive and directory, if necessary) 
  167.        of the sick file. 
  168.  
  169.        Outfile is the name (including drive and directory, if 
  170.        necessary) of the fixed output file. 
  171.  
  172.        -M, which is optional, controls colors, as described above.  (Do 
  173.        not use the brackets; they simply indicate that -M is optional.) 
  174.  
  175.  
  176.        For example,
  177.  
  178.        C>WPMD c:\wp50\letters\John.wp5 c:\wp50\letters\John.fix -M 
  179.  
  180. When run from the command line, rather than interactively, WPMD may 
  181. respond with various messages and then stop.  If it does, you have to 
  182. figure out what to do next.  For example, WPMD may tell you it can't 
  183. find the input file.  In that case, you should see if there is an error 
  184. on your command line.  But some messages make clear that WPMD thinks 
  185. there are problems in the input file that it cannot handle in the 
  186. Ordinary Way.  At that point, you have two choices.  First, you can 
  187. give up.  Second, you can try Drastic Surgery. 
  188.  
  189.  
  190. Using Drastic Surgery
  191. ---------------------
  192.  
  193. As with the Ordinary Way, you can use Drastic Surgery entirely from the 
  194. DOS command line.  That is complicated, and we will explain interactive 
  195. operation first. 
  196.  
  197. Drastic Surgery, as noted above, replaces your document's prefix by 
  198. another prefix.  It can create a prefix by itself, but that prefix will 
  199. not have a good deal of useful information that is stored in the prefix 
  200. of your document, such as Initial Codes, Graphics, Styles, and so 
  201. forth.  If you have a good WordPerfect document with a similar prefix -
  202. - that is, a prefix likely to have much the same information as the 
  203. prefix on your sick document -- WPMD can use that prefix instead.  Once 
  204. you tell WPMD that you want to use Drastic Surgery, it asks you whether 
  205. you want to use the prefix from another document.  Answer with a Y or 
  206. N.  If you answer Y(es), WPMD then asks you to supply the name of 
  207. another file, the file with the prefix you want to use. (You can 
  208. respond with wildcards, as in the case of the input file.)  If you 
  209. leave that filename blank, or if you supply the name of either your 
  210. input or your output file, WPMD will use the prefix it creates; 
  211. otherwise, it will take the prefix from the file you named. 
  212.  
  213. In order to put a new prefix before the text of your document, Drastic 
  214. Surgery needs to know the "offset," the location, in the file where the 
  215. text part of your document begins.  That information is stored very 
  216. close to the beginning of a normal WordPerfect document.  Of course, 
  217. you would not be using Drastic Surgery if your document were a normal 
  218. WordPerfect document.  Therefore, the information stored in the file 
  219. where the offset of the start of the text is supposed to be stored may 
  220. not be valid.  Nevertheless, that information is worth trying.  WPMD 
  221. reads the information.  If it thinks that indicates a plausible file 
  222. offset, WPMD asks you whether you want to try Drastic Surgery using 
  223. that offset.  To help you decide whether to try that offset, WPMD also 
  224. tells you the number of bytes there would be in the text part of your 
  225. document if that were the offset of the beginning of the text.  If you 
  226. think that number of bytes is at all plausible, you might as well let 
  227. WPMD run Drastic Surgery using that offset.  At best, it is the right 
  228. offset.  At worst, it is wrong, the output file is not very good, and 
  229. you try Drastic Surgery again.  In other words, let WPMD try Drastic 
  230. Surgery with the internally stored offset information unless you have a 
  231. very good reason not to.  The usual good reason is that you have 
  232. already tried that once.  There can be other good reasons.  If the file 
  233. you are trying to fix is a 200 page document and WPMD says that, based 
  234. on the internally-stored offset, the text of the file is 500 bytes, the 
  235. internally stored value is not likely to be right. 
  236.  
  237. If you decide not to use the offset stored internally, you have to tell 
  238. WPMD where the text part of the document begins.  So that you can do 
  239. this, WPMD displays your file in a conventional "hex mode" manner.  As 
  240. an example, we use a simple file, which contains nothing but the 
  241. sentence "This is an example."  The hex mode display looks something 
  242. like this (some blank columns have been deleted, for better fit on the 
  243. page): 
  244.  
  245.  
  246. ╒═════════════════════════════════════════════════════════════════════════╕
  247. │000000  FF 57 50 43 3B 01 00 00 01 0A 00 00 00 00 00 00  .WPC;...........│
  248. │000010  FB FF 05 00 32 00 FF 00 00 00 07 00 0F 00 00 00  {...2...........│
  249. │000020  42 00 00 00 02 00 56 00 00 00 51 00 00 00 0C 00  B.....V...Q.....│
  250. │000030  57 00 00 00 A7 00 00 00 03 00 01 00 00 00 FE 00  W...'.........~.│
  251. │000040  00 00 43 6F 75 72 69 65 72 20 31 30 20 63 70 69  ..Courier 10 cpi│
  252. │000050  00 00 00 FF FF 6D 00 5B 00 78 00 78 00 78 00 0A  .....m.[.x.x.x..│
  253. │000060  00 01 00 00 00 00 00 C2 01 40 1D C2 01 78 00 14  .......B.@.B.x..│
  254. │000070  1E 0C 17 8C 0A 00 00 00 04 11 40 C9 00 29 73 E5  ..........@I.)se│
  255. │000080  01 1B 00 FE FE FE FE FE FE FE FF FE FF FF FF FF  ...~~~~~~~.~....│
  256. │000090  FF FF FE FF FF FF FF FF FF FF FF FF FF FF FF FF  ..~.............│
  257. │0000A0  FF FF FF FF FF FF FF 50 61 6E 61 73 6F 6E 69 63  .......Panasonic│
  258. │0000B0  20 4B 58 2D 50 31 30 39 31 00 00 00 00 00 00 00   KX-P1091.......│
  259. │0000C0  00 00 00 00 00 00 00 00 00 00 00 00 50 41 4B 58  ............PAKX│
  260. │0000D0  50 31 30 39 2E 50 52 53 00 DB 01 78 00 14 1E 0C  P109.PRS.[.x....│
  261. │0000E0  17 8C 0A 00 00 00 04 11 40 C9 00 87 CF 01 00 01  ........@I..O...│
  262. │0000F0  00 00 00 00 00 00 00 58 02 18 3D 13 22 04 82 FB  .......X..=."..{│
  263. │000100  FF 05 00 32 00 00 00 00 00 06 00 08 00 00 00 31  ...2...........1│
  264. │000110  01 00 00 08 00 02 00 00 00 39 01 00 00 00 00 00  .........9......│
  265. │000120  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................│
  266. │000130  00 00 23 7C 00 78 00 00 00 00 00 54 68 69 73 20  ..#|.x.....This │
  267. │000140  69 73 20 61 6E 20 65 78 61 6D 70 6C 65 2E        is an example.  │
  268. ╘═════════════════════════════════════════════════════════════════════════╛
  269.                 Press [ESC] when cursor is at doc start
  270.  
  271.                                                                            
  272. Most users will care only about the sixteen columns at the right of the 
  273. screen, where the cursor will stay.  Those columns display the bytes in 
  274. your file (including the bytes in the prefix), usually as ascii 
  275. characters, although some are displayed as dots.  In the rest of the 
  276. screen, the first column of six digit numbers has the offset, in 
  277. hexadecimal, of the first byte displayed on the line -- most users of 
  278. WPMD will, and should, ignore this column.  The next sixteen columns of 
  279. two digit numbers are the hexadecimal representation of the sixteen 
  280. bytes shown on the right.  Again, most users will, and should, ignore 
  281. the hexadecimal values. 
  282.  
  283. In the example, the entire file fits on a single screen.  Most files 
  284. will not.  You need to move around the document looking for the 
  285. beginning of the text and then put the cursor on the first character in 
  286. the text (in this case, the T in This).  In moving around the file, you 
  287. can use conventional cursor keys, PageUp and PageDown, Home to get to 
  288. the beginning of a line of sixteen characters, End to get to the end of 
  289. it, CtrlPgDown to get to the end of the file, and CtrlPgUp to get to 
  290. the beginning. 
  291.  
  292. In addition to moving around with the cursor movement keys, you can 
  293. search for text automatically.  To search for a text string, hit CtrlQ 
  294. and then F.  You will be asked to enter the string.  Type it and hit 
  295. the Enter key.  You will be prompted for search options.  The valid 
  296. options are U, G, and B.  Enter as many of them as you want to use and 
  297. hit enter.  Option U is used if you want a case insensitive search; if 
  298. you do not use it, the search is case sensitive.  The other two options 
  299. control the search direction.  By default, the search is from the 
  300. cursor to the end of the file.  Option B results in a backward search 
  301. to the beginning of the file.  Option G will search the entire file.  
  302. To repeat a search, hit CtrlL. 
  303.  
  304. You may find it convenient to set "markers" in the file -- candidate 
  305. locations of the start of the text.  You can set up to four markers, 
  306. numbers 0 through 3.  To set a marker at the cursor location, type 
  307. CtrlK followed by the number of the marker.  You can jump to a marker 
  308. you have previously set by typing CtrlQ followed by the number of the 
  309. marker. 
  310.  
  311. It is not always easy to find the beginning of the text of the 
  312. document.  Document prefixes can be many thousands of bytes long, so 
  313. you may have to do a lot of paging down.  And the prefix may contain 
  314. information that looks like it should be part of the text.  For 
  315. example, the document summary is contained in the prefix, and it may 
  316. contain a copy of part of the document text.  Styles are stored in the 
  317. prefix, and they may contain chunks of text.  Examine the display 
  318. carefully and try to avoid treating these chunks of text as the 
  319. beginning of the document. (There is, unfortunately, another 
  320. circumstance making it impossible to find the beginning of the text 
  321. part of the document.  It is not always there.  If you do not see 
  322. anything resembling the start of your text anywhere in the display of 
  323. the file, your document is too badly damaged to be recovered, or else 
  324. it is a "locked" -- that is, password protected -- document.  WPMD 
  325. cannot fix locked documents.) 
  326.  
  327. When you find the first word in the text, it may nevertheless not be 
  328. located at the true beginning of the text part of the document.  For 
  329. example, if the sentence in our example file had been indented with a 
  330. tab, the beginning of the text part of the file would actually have 
  331. been a string of nine bytes very few people would recognize as 
  332. representing a tab.  Other function codes at the start of a document 
  333. are also represented by unrecognizable strings of bytes.  For a reason 
  334. explained below, function codes like this are not a serious problem, 
  335. and you should not worry about them.  Codes that contain text, however, 
  336. including headers, footers, and comments, are more of a problem.  If 
  337. you treat text within a header, footer, comment, style, or similar 
  338. structure as the beginning of the text of your document, the results 
  339. will not be satisfactory, and it may be necessary to use the Ordinary 
  340. Way on the output of Drastic Surgery. 
  341.  
  342. When you have decided on what to take as the beginning of the text of 
  343. the document, move the cursor to it and hit the ESC key.  WPMD will 
  344. then display the hexadecimal offset of that location in the file.  You 
  345. can edit that number, or you can simply hit ENTER to accept it.  It is 
  346. difficult to imagine any circumstance in which you would want to edit 
  347. that number. 
  348.  
  349. WPMD then asks you whether you want it to search backwards through the 
  350. file for codes.  Unless you have a very good reason for answering N(o), 
  351. you should answer Y(es).  If you do, WPMD will move backwards in the 
  352. file from the offset you located, seeing if there are valid WordPerfect 
  353. codes.  If there are any, WPMD will consider them as part of the text 
  354. part of the document and adjust the offset accordingly.  That is why 
  355. you need not worry too much about codes like tabs before the character 
  356. you identify as the start of the text of the document.  (This 
  357. description may make it sound as though you could simply move the 
  358. cursor to the end of the file, treat that as the offset of the 
  359. beginning of the text, and let WPMD do the work of finding the 
  360. beginning of the text part of the document.  Unfortunately, that will 
  361. not work, for two reasons.  First, WPMD will search backwards only for 
  362. about 15,000 bytes.  Second, WPMD will stop searching backwards the 
  363. first time it finds an invalid code.  Since you would not be using WPMD 
  364. if you knew the file to be in perfect shape, there is a risk that there 
  365. are invalid codes.  If you leave the cursor inside a function code, 
  366. such as a header, footer, or comment, WPMD will think the beginning of 
  367. that function code is an invalid code.) 
  368.  
  369. Once you have answered the backward searching question, WPMD proceeds 
  370. to process your file. 
  371.  
  372.        If you prefer, you can use Drastic Surgery from the DOS command 
  373.        line, avoiding some or all of the interactive program operation.  
  374.        The DOS command line looks like this: 
  375.  
  376.        C>WPMD Infile Outfile -d[hex] [-gfilespec] [-m]
  377.  
  378.        The optional -gfilespec identifies the file from which you want 
  379.        to take a prefix to use on your output document, as described 
  380.        above. 
  381.  
  382.        If you use -d without the optional hexadecimal offset value, 
  383.        WPMD will proceed to find the offset, with your help, as 
  384.        described above.  Alternatively, you can supply the offset 
  385.        immediately following the -d, for example, -dF14, and avoid all 
  386.        interactive operation.  The user will rarely know the offset, so 
  387.        this option will rarely be used.  But you may sometimes know it.  
  388.        For example, if your file gets completely trashed, and you use a 
  389.        disk sector editing tool to recover it, you might well recover 
  390.        only the text part of the document, so the file would have no 
  391.        prefix.  In that case, the offset of the start of the text part 
  392.        of the document is 0. 
  393.  
  394. When Drastic Surgery finishes, the next step is to read the output file 
  395. into WordPerfect.  If all has gone well, you will have a healthy 
  396. document again.  If not, you should try using the Ordinary Way on the 
  397. new document. 
  398.  
  399. David Seidman
  400. Software by Seidman
  401. 2737 Devonshire Pl. NW
  402. Washington, DC 20008
  403. FAX: (202) 462-8601
  404. CompuServe: [70441,2414] 
  405. GEnie: D.SEIDMAN 
  406.  
  407.  
  408. In addition to WPUSERS on CompuServe and the WordPerfect RT on GEnie, I 
  409. monitor three networked WordPerfect BBS conferences more or less 
  410. regularly, and you can leave questions or suggestions for me in any of 
  411. them.  You are likely to get a faster response if you leave the message 
  412. on the BBS I call than if you count on the network to get your message 
  413. to me and mine to you.  The networks are listed below, along with the 
  414. BBS I call for each. 
  415.  
  416.  
  417.        Smartnet             Arlington Software Exchange, 703-532-7143
  418.        Metrolink/RIME       D.C. Information Exchange, 703-836-0748
  419.        FIDO                 Free Spirit, 301-283-8917
  420.  
  421.  
  422. NOTE:  WordPerfect is a registered trademark of the WordPerfect 
  423. Corporation. 
  424.                           LICENSE INFORMATION
  425.  
  426.  
  427. WPMD is not in the public domain.  It is fully protected by copyright. 
  428.  
  429. WPMD is distributed as shareware (without the documentation in 
  430. WordPerfect format).  If you obtain a copy without paying the license 
  431. fee, you are granted without charge a limited license which permits (a) 
  432. use of the program for a reasonable period for evaluation and testing; 
  433. (b) making copies for distribution to others without charge, provided 
  434. the program and the accompanying documentation are distributed together 
  435. and without modification; (c) posting the program, together with the 
  436. accompanying documentation, on electronic bulletin board systems. 
  437.  
  438. How long is a reasonable period?  The idea of shareware is that you 
  439. should be able to try a program before deciding to buy it.  But unless 
  440. you have a broken WordPerfect 5 file, you really are not in a position 
  441. to try WPMD.  You probably would like to keep WPMD around as a kind of 
  442. insurance policy, hoping that if a problem ever develops with a 
  443. WordPerfect 5 file, WPMD can help fix it.  Although I would prefer that 
  444. you sent your license fee simply because you have heard WPMD is a good 
  445. program, it is reasonable that you would not do so. 
  446.  
  447. Once you have tried WPMD on one of your broken files and found that it 
  448. does work, the clock starts ticking on reasonableness.  After all, if 
  449. WPMD saved a single file of any substantial size for you, you should 
  450. not have to wait for more information before deciding it is worth the 
  451. registration fee.  I think more than two weeks after that point is 
  452. unreasonable.  And that is what a "reasonable period" means for 
  453. purposes of this license. 
  454.  
  455. Use after the reasonable evaluation and testing period requires payment 
  456. of a license fee.  For a single copy (plus necessary archival copies), 
  457. to be used on only one computer at a time, the fee is $35.00.  For your 
  458. convenience, an invoice form is included below.  For large quantities, 
  459. discounts and site licenses are available.  Write for information.  Any 
  460. license for which payment is properly made is valid for this version of 
  461. WPMD and all subsequent versions. 
  462.  
  463. What do you get for your license fee?  Aside from permission to use the 
  464. program and the warm feeling that you are not violating the copyright 
  465. laws, not very much, but a little.  You will receive the latest version 
  466. of the program, along with the documentation in WordPerfect format, and 
  467. you will receive notice of significant program upgrades, which you may 
  468. order for a small shipping and handling fee.  Further, if you let me 
  469. know about any problems you have with the program, I will try to solve 
  470. them.  A license if valid for all versions of WPMD, not just the 
  471. current one.  The only upgrade fee is for shipping and handling. 
  472.  
  473. Users groups and other not-for-profit organizations may distribute 
  474. unmodified copies of WPMD, together with its accompanying 
  475. documentation, for a fee to cover duplication and related costs, not to 
  476. exceed $6.00.  Certain organizations may have been granted permission 
  477. to distribute the program for a fee larger than $6.00, the larger fee 
  478. to include the license fee for a single copy.  If the organization from 
  479. which you received a copy of the program has been granted that 
  480. permission, it should tell you so. 
  481.  
  482. The United States Department of Justice is granted a license, without 
  483. payment of fee, for all official use of WPMD. 
  484.  
  485.  
  486.                           WARRANTY INFORMATION
  487.  
  488.  
  489. WPMD is distributed without warranties of any kind, express or implied, 
  490. including, but not limited to, the implied warranties of 
  491. merchantability and fitness for a particular purpose. 
  492.  
  493. No representation or other affirmation of fact, including but not 
  494. limited to statements regarding suitability for use, or performance of 
  495. WPMD, shall be or be deemed a warranty by the licensor for any purpose, 
  496. nor give rise to any liability or obligation of the licensor whatever. 
  497.  
  498. In particular, no statement in program documentation shall be deemed a 
  499. representation or warranty that the program will perform in any 
  500. particular manner, or perform in any manner whatsoever, or that the 
  501. program is suitable for any particular use or any use at all. 
  502.  
  503.  
  504.                             RELATED PROGRAMS
  505.  
  506.  
  507. FIXPRE --
  508.  
  509. FIXPRE, which is also useful in curing the ills of WPerf5 files, is 
  510. part of the shareware package WPTOOLS.  The description below gives 
  511. some idea of the situations in which FIXPRE may solve problems with 
  512. WordPerfect files.  We cannot describe all the circumstances, because 
  513. FIXPRE often helps with problems new to us. 
  514.  
  515. WPTOOLS is a collection of 14 shareware utilities for use with WPerf5, 
  516. with an additional six provided to registered users.  These utilities 
  517. are DOS programs intended for use with WPerf5 for DOS, but most of them 
  518. are also useful with WPerf5 for Windows.  At this writing, the latest 
  519. version of WPTOOLS is 5.1b.  WPTOOLS is available on many BBSs, on 
  520. CompuServe in the WPSGA forum, and on GEnie in the WordPerfect RT.  Or 
  521. you can order it for $25 from Software by Seidman, plus $2.00 for 
  522. shipping and handling.  For your convenience, an order form appears 
  523. below. 
  524.  
  525.  
  526. Here are brief descriptions of all 20 WPTOOLS programs:
  527.  
  528.  
  529.  
  530. COMMENTS         Reads one or more WP5 document files, extracts the 
  531. comments, and writes them to a WPerf file or to standard output. 
  532.  
  533. DISKFONT         Searches a directory for specified soft font files and, 
  534. optionally, lists descriptive information about the fonts it finds. 
  535.  
  536. ENDFOOT          Converts all footnotes (endnotes) to endnotes 
  537. (footnotes), changing automatic references appropriately. 
  538.  
  539. FIXPRE           Removes deleted (and optionally other) data packets 
  540. from the prefix of WP5 document files and removes deleted data packets 
  541. from WP5 (and other WPCorp) setup files (e.g., WP{WP}.SET).  For 
  542. document files, this will often facilitate changing the printer driver 
  543. used with the file and shrink the file.  Setup files grow as you modify 
  544. your setup; FIXPRE shrinks them again.  And FIXPRE sometimes helps when 
  545. WP5 just seems to be acting strangely.  Optionally deletes styles, 
  546. initial codes, document summaries, and graphics. 
  547.  
  548. FONTFILE         Lists the file names of the soft font files specified 
  549. in a PRS file. 
  550.  
  551. FONTLIST         Lists the names of the fonts used in a WP5 document 
  552. and the PRS file the document calls for. 
  553.  
  554. IS5XDOC          Identifies WP5 document files.  Useful in batch files. 
  555.  
  556. LISTMACS         Lists the names and descriptions of macros in WPM and 
  557. WPK files (and the keys for WPK macros), optionally sorted.  Also works 
  558. with PP5 and DR macro and keyboard files. 
  559.  
  560. MAKETABS         Converts an ASCII text file to a WP50 document, 
  561. replacing spaces by tabs.  Used with columnar material. 
  562.  
  563. MASTER           Reads a WP5 master document and lists the unexpanded 
  564. subdocuments it calls for. 
  565.  
  566. MERGESUM         Creates (or adds to) a WP50 secondary merge file, each 
  567. record containing the information from a WP5 document summary (or, 
  568. optionally, the first 400 or so characters of a document if no summary 
  569. was created), along with information from the DOS file directory.  In 
  570. effect, creates a database of document summaries that can be processed 
  571. using the WP5 Merge and Sort functions, or WordPerfect's Notebook 
  572. program. 
  573.  
  574. PRINTIT          Paginates and formats an ASCII text file for printing. 
  575.  
  576. PRSFONTS         Lists and optionally numbers the names of the fonts 
  577. available in a WP5 PRS file. 
  578.  
  579. STYLIST          Lists names and descriptions of styles, optionally 
  580. sorted. 
  581.  
  582. STYLEUSE         Lists the styles used in the text of a document.  
  583. Lists the styles found in the prefix but not used in the document.  
  584. Optionally deletes unused (or all) styles from the prefix.  Optionally 
  585. deletes style on and off codes from the text of a document, leaving the 
  586. codes added by the style. 
  587.  
  588. TARGETS          Lists the automatic reference targets and references 
  589. in a WP5 document file, indicating unreferenced targets and references 
  590. to nonexistent targets. 
  591.  
  592. WHATPTRS         Lists the printers described in ALL files, optionally 
  593. sorted by printer name. 
  594.  
  595. WP5LOOK          Displays one or more WP5 document files specified on 
  596. the command line, piped to the program, or entered in response to 
  597. prompts.  Particularly because files can be specified with wildcards, 
  598. WP5LOOK may be more convenient than WP5 itself for browsing through WP5 
  599. documents.  Also displays non-WP5 files. 
  600.  
  601. WPGSIZE          Extracts and lists the dimensions of the image 
  602. coordinate space for WPG files.  Useful in getting the aspect ratio 
  603. right. 
  604.  
  605. WPSNOOP          Determines, in greater or lesser detail, the file type 
  606. of many, but not all, files associated with recent WordPerfect 
  607. Corporation products.  For WP5 document files, lists the document 
  608. summary and the PRS file.  For macro files, lists the description.  
  609. Optionally reveals the structure of WP5 document file prefixes and of 
  610. set file prefixes. 
  611.  
  612.                -----------------------------------------
  613.  
  614. SHOWCODE --
  615.  
  616. Reveal Codes can be very helpful in figuring out what went wrong with a 
  617. WPerf5 document.  But it is difficult to examine a lengthy document in 
  618. Reveal Codes.  SHOWCODE allows you to print out almost exactly what you 
  619. would see in Reveal Codes if you used Reveal Codes on an entire 
  620. document.  SHOWCODE is part of MORE TOOLS. 
  621.  
  622. MORE TOOLS is a collection of 9 shareware utility programs (plus two 
  623. additional utilities, including SHOWCODE, for those who register) for 
  624. use with WPerf5, including both Windows and the DOS versions.  All of 
  625. the programs are useful with WPerf51 for DOS.  A few are not useful 
  626. with WPerf51 for Windows or WPerf50.  When released, MORE TOOLS will be 
  627. available on many BBSs, on CompuServe in the WPUSERS forum, and on 
  628. GEnie in the WordPerfect RT.  Or you can order it for $25 from Software 
  629. by Seidman, plus $2 for shipping and handling.  An order form appears 
  630. below.  Release of MORE TOOLS is expected in October 1992. 
  631.  
  632. Here are brief descriptions of the MORE TOOLS programs: 
  633.  
  634. ADDPRS           A tool for network administrators, allowing selective 
  635. updating of printer definitions in personal setup files from the 
  636. definitions in the master setup file.  More flexible than NWPSETUP. 
  637.  
  638. AUTHOR           A tool for managing legal table of authorities 
  639. marking.  Generates (as a secondary merge file) a list of the full 
  640. forms and associated short forms used in a document. 
  641.  
  642. CONCATWP         Combines a group of WP5 files into a single file, with 
  643. or without separators between files.  Useful for combining text and 
  644. saving disk space. 
  645.  
  646. FREEZE           "Freezes" styles, cross-references, and paragraph 
  647. numbers, converting them to ordinary text so that they are no longer 
  648. subject to change without explicit editing. 
  649.  
  650. LFSD             Simulates List Files, but allows the files to be 
  651. sorted in reverse date order (most recent first), date order, by 
  652. extension, or by file name.  For WP51 for DOS. 
  653.  
  654. MPSET            Sets environmental variables in the DOS master 
  655. environment.  Aids communication between WP5 and other programs through 
  656. environmental variables. 
  657.  
  658. PRIMO            Converts merge codes to (bolded) ordinary text, for 
  659. convenient printing and debugging of primary (or secondary) merge 
  660. files.  Much faster than the CODES macro. 
  661.  
  662. SHOWCODE         Converts a WP5 file into more or less what you would 
  663. see in Reveal Codes.  A much more complete conversion than the CODES 
  664. macro provides, and much, much faster. 
  665.  
  666. SHOWSET          Lists most of the information in SET files.  Find out 
  667. what the default settings are without searching in WP5, print for 
  668. future reference. 
  669.  
  670. STYLIB           Helps manage your styles.  Create a new style library 
  671. by selecting styles from any or all of your existing style libraries 
  672. and documents. 
  673.  
  674. WFWP     Computes and lists the frequencies of words in WP5 files. 
  675.  
  676.  
  677.                      * * * * * * * * * * * * * * *
  678.  
  679.                                 INVOICE
  680.  
  681.  
  682. David Seidman
  683. Software by Seidman
  684. 2737 Devonshire Pl. NW
  685. Washington, DC 20008
  686.  
  687.                                                      DATE:
  688.  
  689. SOLD TO:
  690.  
  691. __________________________
  692. __________________________
  693. __________________________
  694.  
  695.  
  696.    ┌──────────────────────────────────────┬────────────────────────┐
  697.    │ Description                          │     Price              │
  698.    │                                      │                        │
  699.    ├──────────────────────────────────────┼────────────────────────┤
  700.    │                                      │                        │
  701.    │ License for WPMD                     │      $   35.00         │
  702.    │                                      │                        │
  703.    │ additional licenses @ $35.00         │       _____.__         │
  704.    │                                      │                        │
  705.    │                                      │                        │
  706.    │                                      │                        │
  707.    │                                      │                        │
  708.    └──────────────────────────────────────┴────────────────────────┘
  709.  
  710.                                     Total:       $_____.__
  711.      D.C. Residents add 6% D.C. Sales Tax:          ___.__
  712.  
  713.                              Total Charge:       $_____.__
  714.  
  715.  
  716. Make checks payable to Software by Seidman.
  717.  
  718. For Credit Card orders, Circle one:   VISA   MasterCard  Diners Club
  719.  
  720. Card Number:     __________________________  Exp. Date: _____________
  721.  
  722. Name on card:    __________________________________________________
  723.  
  724. Signature:       __________________________________________________
  725.  
  726. ------------------------------------------------------------
  727.  
  728.  
  729.                                ORDER FORM
  730.  
  731.  
  732. David Seidman
  733. Software by Seidman
  734. 2737 Devonshire Pl. NW
  735. Washington, DC 20008
  736.  
  737.                                                      DATE:
  738.  
  739. SHIP TO:
  740.  
  741. __________________________
  742. __________________________
  743. _________________________
  744.  
  745.  
  746. ┌──────────────────────────────────────────┬────────────────────────┐
  747. │ Description                              │     Price              │
  748. │                                          │                        │
  749. ├──────────────────────────────────────────┼────────────────────────┤
  750. │                                          │                        │
  751. │ __ Licensed copies of WPTOOLS @$25.00    │      $ _____.__        │
  752. │                                          │                        │
  753. │ __ Licensed copies of MORE TOOLS @$25.00 │        _____.__        │
  754. │                                          │                        │
  755. │                                          │                        │
  756. │                                          │                        │
  757. │                                          │                        │
  758. └──────────────────────────────────────────┴────────────────────────┘
  759.  
  760.                                       Total:       $_____.__
  761.        D.C. Residents add 6% D.C. Sales Tax:          ___.__
  762.                       Shipping and handling:            2.00
  763.  
  764.                                Total Charge:       $_____.__
  765.  
  766.  
  767. Make checks payable to Software by Seidman.
  768.  
  769. For Credit Card orders, Circle one:   VISA   MasterCard  Diners Club
  770.  
  771. Card Number:     __________________________  Exp. Date: _____________
  772.  
  773. Name on card:    __________________________________________________
  774.  
  775. Signature:       __________________________________________________
  776.  
  777. ------------------------------------------------------------
  778.  
  779.  
  780.